home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 11 / 2 / DISK1127.ZIP / TERRA50.EXE / TT.DOC < prev    next >
Text File  |  1990-03-31  |  33KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.          ************************************************************
  6.          *                                                          *
  7.          *                                                          *
  8.          *               T  E  R  R  A  *  T  I  M  E               *
  9.          *                                                          *
  10.          *                        Version 5.0                       *
  11.          *                                                          *
  12.          *                      (C)opyright 1990                    *
  13.          *                    All Rights Reserved                   *
  14.          *                                                          *
  15.          *==========================================================*
  16.          *                                                          *
  17.          *                    GeoGraphics Software                  *
  18.          *                   126 Mountain View Road                 *
  19.          *                    Glastonbury, CT 06033                 *
  20.          *                                                          *
  21.          *----------------------------------------------------------*
  22.          *                                                          *
  23.          *     Terra∞Time is user-supported software provided to    *
  24.          *   you at no charge on a trial basis.  If you use this    *
  25.          *   software and find it of value please register your     *
  26.          *     copy for $20.00 and support the shareware concept.   *
  27.          *    Registered users will be provided with information    *
  28.          *    about program updates. Please make checks payable     *
  29.          *          to G. K. Marek at the above address.            *
  30.          *                                                          *
  31.          *      You are encouraged to share this software with      *
  32.          *      others provided that it is distributed complete     *
  33.          *      with documentation and in unmodified form and       *
  34.          *     that no fee or other consideration is charged or     *
  35.          *     accepted.  All commercial, business and government   *
  36.          *           users must register each copy in use.          *
  37.          *                                                          *
  38.          *  We hope you enjoy using Terra∞Time.  Your comments and  *
  39.          *  suggestions to improve this product are always welcome. *
  40.          *  Please refer to TT Version Number 5.0 in your comments. *
  41.          *                                                          *
  42.          *                                                          *
  43.          ************************************************************
  44.  
  45.  
  46.  
  47.  
  48.  
  49. PROGRAM DESCRIPTION
  50.  
  51. Terra∞Time is a program which tracks and displays the local time in as
  52. many as 64 cities all around the globe.  Unlike other programs of this
  53. type, Terra*Time accounts not only for time zone effects but also for
  54. daylight savings time at each city.  Information is provided on a
  55. full-screen color display.  Windows and menu-driven commands are used
  56. for program modifications.  Program options provide users with the
  57. ability to tailor the display for their specific needs.  Military or 12
  58. hour clock can be selected and the layout of the world map can be varied
  59. to suit the user.  Additional program features include time zone
  60. differences, great circle distances between cities, currency conversion
  61. and a special alarm feature which can be set for any world city time.
  62.  
  63.  
  64. HARDWARE REQUIREMENTS
  65.  
  66. This program is designed for IBM Personal Computers and close
  67. compatibles.  It will execute on the IBM-PC, PC-XT, PC-AT, PS/2 and
  68. PC-jr.  DOS Version 2.0 or later is required.  Terra∞Time does not
  69. require an internal clock and will accept the time set by you during DOS
  70. boot-up.  Of course, the use of the internal clock will allow for
  71. automatic timekeeping.
  72.  
  73. Since the program relies extensively on color, a color monitor is
  74. recommended.  The program will run, however, unmodified, on many
  75. monochrome machines.  Terra∞Time requires about 128K of memory and does
  76. not require BASIC to operate.
  77.  
  78.  
  79. PROGRAM FILES
  80.  
  81. The Terra∞Time system comes in five files which are transmitted in a
  82. special self-extracting archive file called TERRA50.EXE.  Just running
  83. this file causes it to create a fresh original copy of all of the files
  84. below (no archiving programs are required):
  85.  
  86.     File        Size    Description
  87.     ---------  ------   --------------------------------------------
  88.     TT.EXE     104472   executable program module
  89.     TT.DAT       6250   default settings and cities information
  90.     TTDAT.BAK    6250   back-up duplicate copy of TT.DAT
  91.     TT.DOC              documentation file (ASCII); (this file)
  92.     TTREAD.ME           short program description with latest changes
  93.  
  94. All files are dated 31 March 1990.  Please check that your files have
  95. corresponding dates and sizes as a measure of protection against
  96. viruses.  The first two files must reside on the current directory or
  97. path for the program to be accessible.
  98.  
  99. None of these files is copy-protected.  The original self-extracting
  100. archive file (TERRA50.EXE) should be saved as a backup on a separate
  101. disk.  Just run this file again to create a fresh original copy of all
  102. the above files.
  103.  
  104. Please distribute as shareware only the archive file TERRA50.EXE since
  105. it contains all of the program files in their original state in a
  106. compact, single package.
  107.  
  108. Terra∞Time is executed from the current directory or path with this
  109. command at the DOS prompt:
  110.  
  111.                  TT [FN]
  112.  
  113. The optional argument [FN] (FileName) allows the user to specify an
  114. alternative data file to read in city information.  If [FN] is omitted,
  115. data is read from the file called TT.DAT.  If a filename is specified
  116. without an extension, Terra∞Time adds .DAT as the extension.  The data
  117. filename used is displayed in the upper left of the map unless it is
  118. TT.DAT.
  119.  
  120.  
  121. PROGRAM START-UP
  122.  
  123. Upon execution, Terra∞Time will load from the current directory and
  124. access the data file (either TT.DAT or [FN]) to load current settings
  125. and cities information.  Once the program and data are loaded, the
  126. program no longer requires these files unless a new configuration is
  127. saved to disk for future use.  The program is virtually self-explanatory
  128. and uses menus extensively.  The program will load into [AutoTime] mode
  129. incorporating the default values and cities information in the selected
  130. datafile at time of execution.
  131.  
  132.  
  133. GENERAL PROGRAM FEATURES
  134.  
  135. Terra∞Time generates a stylized world map with cities indicated by three
  136. letter codes.  The map is divided into 24 time zones each of which is
  137. further divided into three twenty-minute segments.  One timezone,
  138. normally the one you are in, is specially designated as the "Local"
  139. timezone.  The local timezone city (initially set by the program
  140. defaults to New York) is indicated on the top scale by a magenta symbol.
  141. Time and date details about the local time zone as indicated in the
  142. center of the black area below the world map.  The local time indication
  143. is standard time if it is shown in yellow and daylight savings time if
  144. it is shown in brown.
  145.  
  146. The black background on the map itself indicates the portion of the
  147. globe in darkness and moves with the time in twenty minute intervals.
  148. The shape of this background changes with the seasons in the form of a
  149. sinewave to describe true sunrise and sunset.  Cities are indicated on
  150. the map in bright yellow if they are presently on standard time and in
  151. brown if they are presently on daylight savings time.
  152.  
  153.  
  154. HOUR-DAY SCALE
  155.  
  156. Across the bottom of the world map is an hour-day scale with some
  157. features in white and some in yellow.  The white (upper) scale indicates
  158. the STANDARD time in that particular world zone.  One point on this top
  159. scale is the yellow letter M which represents midnight; N indicates
  160. noon.  The lower scale, in yellow, is in the form:
  161.  
  162.                           << Sun | Sat >>
  163.  
  164. and is used to determine the day of the week for any time zone.  The
  165. symbol | represents the International Date Line in the central Pacific
  166. Ocean.  In this example, from this symbol to the left (west), it is
  167. Sunday until the M (midnight) symbol is encountered on the scale above.
  168. It is Saturday toward the east until the M symbol.  Of course, the scale
  169. wraps around at the left and right edges of the map.
  170.  
  171.  
  172. A WORD ABOUT TIME SYSTEMS
  173.  
  174. Terra∞Time displays time using the standard US AM/PM 12 Hour Clock and the
  175. International (or Military) 24 Hour Clock.  However, for simplicity, all
  176. INPUTS to Terra∞Time must be given using the 24 Hour Clock (the same as
  177. DOS).  Some examples of the relationships between the two systems are
  178. shown below:
  179.  
  180.  
  181.                      US/12 Hr   Intl/24 Hr    Input      Input
  182.                                               HH:MM:SS   HHMM
  183.  
  184.          MIDNIGHT    12:00 AM      00.00      00:00:00   0000
  185.                      12:37 AM  =>  00.37      00:37:00   0037
  186.                       1:24 AM      01.24      01:24:00   0124
  187.                      11:08 AM      11.08      11:08:00   1108
  188.  
  189.          NOON        12:00 PM      12.00      12:00:00   1200
  190.                      12:15 PM  =>  12.15      12:15:00   1215
  191.                       3:59 PM      15.59      15:59:00   1559
  192.                      11:49 PM      23.49      23:49:00   2349
  193.  
  194.  
  195.  
  196. The ACTUAL local time (whether daylight or standard) should be input and
  197. Terra∞Time will take care of the rest.  If you have an internal computer
  198. clock, you must set it forward and back during switches between daylight
  199. and standard time just as you do with your other clocks.
  200.  
  201. Some computers have clocks that lose the seconds when time is reset.
  202. For example, the time 10:15:53 would be set to 10:15:00 and 53 seconds
  203. would be lost.  In these cases time adjustments should be made just
  204. after the minute has turned to minimize this time loss effect.
  205.  
  206.  
  207.  
  208. PROGRAM FEATURES
  209.  
  210. Terra∞Time incorporates a number of special features and options which
  211. are explained below.  These features are accessed by selecting the
  212. letter [F] from the [AutoTime] mode.  The program can be exited with a
  213. single keystroke from this mode by pressing the <Escape> key.
  214.  
  215. The menus are executed by selecting the first letter of the desired
  216. option.  Options followed by periods (e.g., [S]ettings..) indicate that
  217. other menus will follow.
  218.  
  219.  
  220. CITY CODES
  221.  
  222. The cities are plotted on the world map using a special city code.  Also
  223. some program features require that a particular world city be
  224. identified.  Each city has been assigned a three letter abbreviation.
  225. These abbreviations can be changed to suit the user.  For example, the
  226. code NYC could be changed to JFK to represent John F. Kennedy airport,
  227. or to HQ, for Corporate Headquarters.  Three letters is a default for
  228. this code, but one to ten characters is acceptable.  It could even be
  229. altered to HFD, (or to "HARTFORD") for Hartford, Connecticut, a nearby
  230. city with the same parameters as New York.  The program allows, and
  231. comes set up with, 59 cities and 5 dummy cities for additional user
  232. input.  The 5 dummy cities are included at the end of the list and are
  233. called ZZZ1, ZZZ2, ZZZ3...  Once a city is renamed, it will appear in
  234. its proper alphabetical order in the city list.  Any of the 59
  235. established cities can also be revised.  So the cities can become
  236. HAM radio stations, corporate subsidiaries, or pen pals.
  237.  
  238. ALARM
  239.  
  240. The Terra∞Time alarm can be set for a specific time in a specific world
  241. city.  This could be the local time or the time in a foreign location.
  242. For example, assume that you are in New York.  You can set the clock to
  243. ring when it is 7PM (1900) in Paris without having to compute time
  244. differences simply by indicating PAR and 1900 when the alarm is set.
  245. Terra∞Time keeps track of the timezones and any savings time that might be
  246. in effect at either city.
  247.  
  248. Activating the alarm will illuminate a note in the lower left corner of
  249. the screen.  The alarm will ring and flash at the appropriate time,
  250. chiming every five seconds for one minute or until any key is selected
  251. to stop it.  The alarm will be turned off once it has rung and will have
  252. to be activated again even to ring again at the same time on the next
  253. day.  The command [Activate] will engage the alarm with the current
  254. settings unchanged.  The [LOC] city code can be used for local time
  255. alarm.  Be sure to input the alarm time in HHMM format, two digits for
  256. the hours and two for the minutes using a 24 Hour clock.
  257.  
  258.  
  259. TIMEZONES
  260.  
  261. The [TimeZones] feature allows you to check the number of hours
  262. (timezones) any city is ahead or behind any other.  A base zone is
  263. initially set to the local city but can be moved to any other city, one
  264. zone at a time, with the [W]est or [E]ast keys.
  265.  
  266.  
  267. LOCK SCREEN
  268.  
  269. Selecting the LockScreen feature allows the user to leave the world
  270. timer map running normally while he leaves the computer with the
  271. keyboard locked so that it cannot be accessed by another person.
  272. Carefully enter a secret code you will remember because you will have to
  273. restart your computer if you forget it.  The flashing bullet will remind
  274. you that this feature is set.  You simply re-enter the secret code to
  275. unlock the program.  When you re-enter the first character the bullet
  276. will change to a question mark to acknowledge your entry.  If you make a
  277. mistake while entering the code, just press the <ENTER> or <RETURN> key
  278. and try again.
  279.  
  280.  
  281. DISTANCES
  282.  
  283. Terra∞Time can also compute the distance between any of the cities in
  284. the program database (not just those shown on the map).  A listing of
  285. cities is windowed.  The distance shown is the "great circle distance,"
  286. which is the shortest distance between the two points on a globe.  This
  287. distance is provided in statute miles (ordinary measure) or in nautical
  288. miles, a system used extensively in air and sea navigation.  One
  289. nautical mile is about 1.151 statute miles.  In addition, each city
  290. distance calculation includes a bearing computation which is the true
  291. heading from the origination city to the destination city.  A bearing of
  292. 90 degrees means that the destination is due east of the origination
  293. city.  This feature is useful for aligning antennas.
  294.  
  295.  
  296. CURRENCY
  297.  
  298. The Currency features determines the monetary rate of exchange between
  299. the countries of the two cities selected.  Since these values are
  300. constantly changing, this conversion rate should be considered as only a
  301. rough estimate.  Currency information can be updated on the [CityData]
  302. menu.  Information for many countries is generally available from the
  303. Wall Street Journal.  The exchange rates provided in TT.DAT are from the
  304. December, 1989, International Financial Statistics published by the
  305. International Monetary Fund, Washington D.C.
  306.  
  307.  
  308. TIMESET/DATESET
  309.  
  310. Times and dates must be valid and follow the format specified.  Dates
  311. cannot precede 1980 since DOS will not recognize any date before
  312. 1-Jan-1980.  Since the Local Time display also computes the
  313. day-of-the-week, this feature will allow the determination of the
  314. day-of-the-week on which some future date will occur, such as a birthday
  315. or Christmas.
  316.  
  317.  
  318. MAPSHIFT
  319.  
  320. The displayed map can be centered on the US, on Europe, or on the Far
  321. East with this option.  There is no effect on the time.
  322.  
  323.  
  324. 12/24 HOUR SELECTION
  325.  
  326. The times displayed with the cities on the map can be presented in
  327. either U.S. 12/Hr format or Intl 24/Hr format using this option.  The
  328. U.S. format suppresses leading zeros.
  329.  
  330.  
  331. LOCALZONE
  332.  
  333. Any city in the Terra∞Time city list can be designated the Local time
  334. city.  The Local Time strip in the black area below the map will take on
  335. the attributes of this designated city and the LocalZone marker on the
  336. top scale will move.  When a new LocalZone is selected the times in all
  337. cities remain unchanged.  Only the alarm, local time strip and other
  338. features using the local time are affected.
  339.  
  340. SOUND COMMAND
  341.  
  342. The sound command enables and disables all program sound.  This setting
  343. is save in the datafile for subsequent default use.  All sound,
  344. including hourly blips and alarm sound is suppressed.
  345.  
  346.  
  347. HEADER COMMAND
  348.  
  349. The title line at the top center of the world map is input with the
  350. header command.  It is automatically centered.  This header is saved
  351. with the other program settings in the datafile.  Any ASCII characters
  352. can be used.
  353.  
  354.  
  355. FILE COMMAND
  356.  
  357. When you have chosen a configuration of features and cities that you
  358. prefer, they can be saved to the TT.DAT file (or other file you specify)
  359. and subsequently automatically loaded with the program.  Any changes
  360. made in program features or options will be in effect only for the
  361. remainder of the current session unless they are saved with the [File]
  362. command.  Once a new configuration is saved in a data file the previous
  363. configuration in that file is erased.  Be sure a backup copy of
  364. TERRA50.EXE has been saved in case you want to start over or reinstate
  365. the original options.  A file called TTDAT.BAK is provided as a backup
  366. duplicate of the original TT.DAT file.
  367.  
  368.  
  369. CITIES DISPLAY
  370.  
  371. The marked cities are set for display on the screen.  Unmarked cities
  372. are not shown.  The mark is toggled with the [Enter] key.
  373.  
  374.  
  375. MOVECITY COMMAND
  376.  
  377. The selected city from the window is moved to a new plotting location
  378. on the map using the arrow keys.  [Enter] fixes the new location, and
  379. [Esc] cancels the move.  Only cities which are displayed can be moved.
  380.  
  381. The 59 cities have been carefully selected and plotted so they remain
  382. relatively true to their intended time zones but so that a minimum will
  383. overlap when they are displayed.  Thus many cities can be displayed
  384. together at once.  Since many U.S. and European cities are close
  385. together, they will overlap if they are all selected at once.  Select
  386. and move cities to provide the most attractive display; but, if
  387. possible, try to keep cities vertically within their correct zones.
  388.  
  389. The following charts show the actual plotting locations in TT.DAT as
  390. a program default.  This will give some idea of which cities can
  391. be displayed and moved to suit your particular purpose.  Remember,
  392. on the chart below each box represents only one plotting character.
  393. The house symbol will plot at this location followed by the city code
  394. (of length 1 to 10) and then the time itself (of length 4 to 6).
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                     UNITED STATES PORTION OF WORLD MAP
  403.        <----WEST                                           EAST---->
  404.             ZONE 9         ZONE 8         ZONE 7         ZONE 6
  405.  
  406. CODE D ║ 90   91   92 ║ 80   81   82 ║ 70   71   72 ║ 60   61   62 ║
  407.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  408. CODE   ║    ║ VCR║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  409. E    8 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  410.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  411.        ║    ║ SEA║    ║    ║    ║    ║ MSP║    ║    ║ TOR║ MTL║    ║
  412.      9 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  413.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  414.        ║    ║ SFO║    ║    ║ DEN║    ║    ║ CHI║ DTW║    ║ PHL║ BOS║
  415.     10 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║ WSH║ NYC║
  416.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  417.        ║    ║    ║ LAX║    ║    ║ DFW║    ║    ║    ║ ATL║    ║    ║
  418.     11 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║ MIA║    ║    ║
  419.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  420.        ║    ║    ║    ║    ║    ║ MEX║    ║    ║    ║    ║    ║    ║
  421.     12 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  422.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  423.  
  424.  
  425.                         EUROPEAN PORTION OF WORLD MAP
  426.        <----WEST                                           EAST---->
  427.             ZONE 1         ZONE 0         ZONE 23        ZONE 22
  428.  
  429. CODE D ║ 010  011  012║ 000  001  002║ 230  231  232║ 220  221  222║
  430.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  431. CODE   ║    ║    ║    ║    ║    ║ STO║ HEL║    ║    ║    ║    ║    ║
  432. E    7 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  433.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  434.        ║    ║ LON║ AMS║ CPH║    ║    ║    ║    ║    ║ MOS║    ║    ║
  435.      8 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  436.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  437.        ║    ║    ║ PAR║ FRA║ ZRH║ VIE║    ║    ║    ║    ║    ║    ║
  438.      9 ║    ║    ║    ║ GVA║    ║    ║    ║    ║    ║    ║    ║    ║
  439.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  440.        ║ MAD║    ║    ║ ROM║    ║    ║    ║    ║    ║    ║    ║    ║
  441.     10 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  442.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  443.        ║    ║    ║    ║    ║    ║    ║    ║ CAI║    ║    ║    ║    ║
  444.     11 ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║    ║
  445.        ╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬════╬
  446.  
  447.  
  448. CITYDATA COMMAND
  449.  
  450. The [CityData] command allows the user to see and change the
  451. attributes of the cities provided in the Terra∞Time database.  For
  452. example, any city can be shown or deleted from the map display.  The
  453. following information about each city is displayed and can be altered as
  454. indicated.
  455.  
  456. CODE - The city code is a one or more character designation.  The
  457. default provided in the original data file is a three letter character
  458. code.  This code is used to identify the city on the map and to select
  459. and save city features.  Any code except LOC can be selected.  For
  460. example, NYC could be replaced by MAN (for Manhattan).
  461.  
  462.  
  463. ZONE - The zone parameter represents the number of timezones east
  464. (positive) or west (negative) of the Prime Meridian (Greenwich, England)
  465. that the subject city lies.  For example New York Zone is -5.0 and Paris
  466. is 1.0.  Some cities are in timezones which are not an exact integer
  467. number of hours from GMT (Greenwich Mean Time).  Bombay, India, for
  468. example, is 5 and one-half hours ahead of GMT. Its zone is indicated as
  469. 5.50, with the .50 indicating 0.50 hours more advance than five hours.
  470. This method is a change from earlier program versions.  Believe it or
  471. not, there are quarter hour timezones in Nepal and other areas.  Any
  472. fractional zone can now be specified as indicated above.
  473.  
  474.  
  475. START DATE OF DAYLIGHT SAVINGS TIME
  476.  
  477. This is a four digit value which indicates the month and day that is the
  478. first day of daylight savings time for this city.  It is specified in
  479. the form MMDD, so 0531 would mean May 31st is the first day of daylight
  480. savings time.  DD can be specified as 00 to indicate that the day should
  481. be the last Sunday of that particular month; for example 0400 would mean
  482. that daylight savings time should start the last Sunday of April.  A
  483. face with a question mark will appear in the lower left of the screen on
  484. the dates the program is told daylight savings time starts and ends in
  485. the local timezone city.  This icon is a reminder to set the clock
  486. forward in the spring and backward in the fall (Northern hemisphere).
  487.  
  488.  
  489. END DATE OF DAYLIGHT SAVINGS TIME
  490.  
  491. This value indicates the LAST day of daylight savings time.  Otherwise,
  492. the comments indicated above for START apply.  Note that it is possible
  493. for the END date to precede the START date when summer comes in the
  494. months of December, January and February as it does in the Southern
  495. hemisphere.
  496.  
  497.  
  498. DAYLIGHT SAVINGS TIME
  499.  
  500. Daylight savings time is a convenience adopted by many localities during
  501. the summer months depending upon their particular needs and their
  502. geographic location.  The information provided for the cities in
  503. Terra∞Time was accurate for 1987-1988.  But these rules are subject to
  504. change depending upon legislation in each country.  For this reason
  505. Terra∞Time allows the changing and saving of information relating to
  506. daylight savings time in the [CityData] menu.  Data regarding country
  507. time zones and daylight savings time rules is available from the local
  508. library or in a reference called the Official Airline Guide (OAG) which
  509. is published monthly and used by most travel agents in the United
  510. States.
  511.  
  512. The Timezone information in this program is data from the February,
  513. 1990, Official Airline Guide.
  514.  
  515.  
  516. NATIONDATA COMMAND
  517.  
  518. Since all cities in a nation use the same monetary units and many cities
  519. have the same start and end daylight dates, this feature allows the
  520. change of these parameters for all cities with the same country code at
  521. one time.  Simply select this option and choose any city with the
  522. desired country code.  Then input the new currency and/or daylight
  523. savings dates and all of the cities' data is automatically changed.
  524.  
  525.  
  526. CREDITS
  527.  
  528. This program uses special functions from the excellent Advanced Function
  529. Library for the Basic Compiler called ADVBAS.LIB v3.4, (C) Thomas Hanlin
  530. III, Alexandria, VA, available on many bulletin boards.
  531.  
  532. Some copies of Terra∞Time are distributed via an excellent self-
  533. extracting archive program called PKARC version 3.5, dated 27 April
  534. 1987, and available from PKWARE, Inc., 7032 Ardara Avenue, Glendale, WI
  535. 53209.
  536.  
  537. I hope Terra∞Time will prove to be of value to you.  Please contact the
  538. author with any problems, useful comments or suggestions at the address
  539. at the top of this file.
  540.  
  541. *+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*
  542.  
  543. TERRATIME SCREENS FLOWCHART
  544.  
  545. [AutoTime]
  546.  ┌ [Esc]                   - Exit from TerraTime
  547.  └ [F] Features..
  548.     ┌ [A] Alarm..
  549.     │  ┌ [A] Activate
  550.     │  ├ [H] Halt
  551.     │  ├ [S] Set
  552.     │  └ [R] Return
  553.     ├ [T] Timezones        -Display City Time Differences
  554.     ├ [L] LockScreen       -Lock Screen with Secret Code
  555.     ├ [D] Distances        -Compute Distances BetweenCities
  556.     ├ [C] Currency         -Currency Conversion Between Cities
  557.     ├ [I] Info             -Displays GeoGraphics Information
  558.     ├ [R] Return           -Return to [AutoTime]
  559.     ├ [Q] Quit             -Exit from TerraTime
  560.     └ [S] Settings..
  561.        ┌ [T] TimeSet       -Set Internal Computer Clock Time
  562.        ├ [D] DateSet       -Set Internal Computer Clock Date
  563.        ├ [M] Mapshift      -Select Central Map Area
  564.        ├ [1] 12/24 Hr      -Choose between Time Formats
  565.        ├ [L] LocalZone     -Select Alternate Local City
  566.        ├ [S] Sound         -Enable/Disable Sound Effects
  567.        ├ [H] Header        -Designate Title at Top of Map
  568.        ├ [F] File          -Save Current Settings to Disk File
  569.        ├ [R] Return        -Return to Previous Screen
  570.        ├ [Q] Quit          -Leave Program; Changes NOT Saved
  571.        └ [C] Cities
  572.           ┌ [D] Display    -Include/Exclude Cities from Display
  573.           ├ [M] MoveCity   -Use Arrow Keys to Move City Location on Map
  574.           ├ [C] CityData   -Alter City Data (Name, Latitude, etc.)
  575.           ├ [N] NationData -Alter Data for Nation (all cities)
  576.           └ [R] Return     -Return to Previous Screen
  577.  
  578. *+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*+*
  579.  
  580. ADVANCED PROGRAMMING CONSIDERATIONS
  581.  
  582. NOTE:  ALL FEATURES IN TERRA∞TIME ARE NOW AVAILABLE FROM WITHIN THE PROGRAM
  583. ITSELF, SO IT IS NOT NECESSARY TO READ OR UNDERSTAND THIS SECTION.
  584. IT IS PROVIDED SIMPLY AS DOCUMENTATION OF THE STRUCTURE OF THE DATAFILE.
  585.  
  586. Terra∞Time is compiled in Basic and reads all of the city information as
  587. well as the default settings from an ASCII file.  The default file is
  588. called TT.DAT but any filename can be specified.  It is not necessary to
  589. examine or edit this file since all values can be conveniently changed
  590. from directly inside of Terra∞Time.  This file can be edited with any
  591. text editor.  Make sure the edited file is saved in "ASCII" format by
  592. your editor or word processor.  The first line of the data file contains
  593. a 40 character header (or title) which will appear centered on the top
  594. portion of the display.  This line can be revised to display any heading
  595. the user desires, but two double quotes is succession ("") are not
  596. allowed.  The next two lines of the file contain default settings,
  597. followed by 64 lines of city data and a terminating line.  Only advanced
  598. users should revise this file since its formatting is critical to ensure
  599. proper reading of the data by the program.  Always save a backup copy
  600. just in case.  The format of some typical city data lines is presented
  601. here:
  602.  
  603. COLUMN   1         2         3         4         5         6         7         8
  604. 12345678901234567890123456789012345678901234567890123456789012345678901234567890
  605.  
  606. FIELD A         B   C     D  E    F   G    H    I    J       K    L       M     N
  607.  
  608. "JAKARTA",      0,"JKT",181,15,  7.00,0,   0,   0, -6.07,-106.39,"IA",1791.05,"Indonesian Rupiahs"
  609. "JOHANNESBURG", 1,"JHB",231,17,  2.00,0,   0,   0,-26.08, -28.15,"SA",   2.63,"S African Rand"
  610. "KARACHI",      0,"KHI",212,12,  5.00,0,   0,   0, 24.54, -67.09,"PK",  21.19,"Pakistani Rupees"
  611. "LAGOS",        0,"LGS",  0,14,  1.00,0,   0,   0,  6.35,  -3.19,"NG",   7.37,"Nigerian Naira"
  612. "LIMA",         0,"LIM", 61,15, -5.00,1, 101, 331,-12.01,  77.07,"PE",4394.51,"Peruvian Intis"
  613. "LONDON",       1,"LON", 11, 8,  0.00,1, 300,1000, 51.28,   0.27,"GB",   0.63,"British Pounds"
  614.  
  615. A comma must delimit (come between) each field and the alphabetic
  616. characters must be in quotes as shown.  The fields have the following
  617. meanings:
  618.  
  619. A => The city name
  620. B => Code to include plotting on map for that city (1) or not (0)
  621. C => City code for plotting on map (default three characters)
  622. D => A code for horizontal plotting location of that city (see below)
  623. E => A code for vertical plotting location of that city (see below)
  624. F => The time zone from Greenwich, England, with eastbound positive
  625. G => Code to indicate daylight savings time is applicable (1) or not (0)
  626. H => Code for start of daylight savings time (described in START above)
  627. I => Code for end of daylight savings time (described in END above)
  628. J => Latitude of city in Degrees and Minutes, with North positive
  629. K => Longitude of city in Degrees and Minutes, with West positive
  630. L => Two letter Country Code to set exchange rates and daylight time
  631. M => Amount of country's currency equivalent to one US Dollar
  632. N => Description of currency and country
  633.  
  634. Code E is a number between 5 and 20 which represents the vertical
  635. plotting location for the given city.  The fifth row down is the highest
  636. (northernmost) plotting location.  The 13th row represents cities that
  637. fall along the equator such as Dakar, in Africa.  The 20th row is the
  638. southernmost plotting position.  You will be able to tell where to plot
  639. a new city by looking at the value of Code E for the cities around it.
  640. All selections for this parameter must be integers from 5 to 20.  The
  641. remainder of the screen is reserved and other values will produce
  642. unpredictable results.
  643.  
  644. Code D is a value which determines the horizontal plotting location of a
  645. particular city.  This code is more complicated than Code E and must be
  646. deciphered to be understood.  The map grid is divided into 24 horizontal
  647. areas, each of which allow three plotting positions, for a total of 72
  648. horizontal plotting locations.  If the last digit of Code D is dropped,
  649. the remaining value is always between 0 and 23.  This code represents
  650. one of the 24 plotting regions starting with Geneva as 0 and moving
  651. westward with New York as 6, Hong Kong as 17, Bombay as 20, and finally
  652. Helsinki as 23.  Note that the last digit of the code is always a 0, 1,
  653. or 2.  This digit represents the plotting position of the point within
  654. the main region with 0 westmost, 1 central and 2 eastmost plotted.  Thus
  655. Chicago, with Code D of 71, is plotted in the central portion of the 7th
  656. zone west.  Note that from west to east the plotting codes would follow
  657. a sequence such as 70,71,72,60,61,62,50,51, etc.  Again, unpredictable
  658. results will occur if these conventions are not followed.
  659.  
  660.                        ** ++ ** ++ ** ++ **
  661.